home *** CD-ROM | disk | FTP | other *** search
/ Inside Mac Games Volume 3 #7 & #8 / IMG 29 JulyAug 1995.iso / More Goodies / Misc Utilities / Aaron 1.0 folder / Aaron Docs next >
Text File  |  1995-07-15  |  16KB  |  177 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8. Aaron version 1.0, July 16, 1995
  9. Copyright © 1991–1995 Gregory D. Landweber and ISYS Development Corp., ALL RIGHTS RESERVED
  10. Brought to you by the authors of Greg's Buttons, Greg's Browser, and DoubleScroll.
  11.  
  12. greg@math.harvard.edu (Greg Landweber) — for everything except the windows and scroll bars
  13. ISYSDev@aol.com (Ed Voas) — regarding the windows and scroll bars
  14.  
  15. (We do not provide snail-mail or telephone support for Aaron.)
  16.  
  17. Please note that we are each getting several dozen e-mail messages a day regarding Aaron. While we do read every message when it comes in, you may not get a prompt response, particularly if you ask a question that is answered here. Please do NOT include screen shots or long lists of all your system extensions. These take up a great deal of space and are rarely useful. If we need such information, we will ask for it.
  18.  
  19. Please do NOT distribute modified versions of Aaron. It is difficult enough to support the versions that we release, and it becomes a nightmare if we have to support versions that we have never seen. Also, please distribute Aaron as a complete package, including Register, Espi Sans 10, and this documentation file.
  20.  
  21. Aaron is a small extension that transforms your Mac's user experience to resemble the Copland 3-D style as shown in recent issues of MacWeek, MacUser, and MacWorld magazines. To use it, just drop it in your Extensions folder, or drop it on your System (MacOS) folder and let the Finder put it where it belongs. When you restart, you will see the changes listed below. To temporarily disable Aaron, hold down the mouse button while it loads at startup.
  22.  
  23. Aaron is a “Fat Binary” containing both 680x0 and PowerPC native code for optimum performance on both Macs and PowerMacs. In other words, Aaron is Accelerated for Power Macintosh. Aaron requires a 68020 or better, so in particular it won't work on a Mac Plus. Sorry.
  24.  
  25. Shareware registration info
  26.  
  27. Aaron is shareware; it is NOT free. If you use Aaron, you should pay a $10 registration fee. Registrations for Aaron ar handled by the Kagi Shareware service run by Kee Nethery (kee@kagi.com). In addition to cash in various currencies and US dollar checks drawn on US banks, Kagi Shareware also accepts credit card registrations by mail, fax, or e-mail (your card number is scrambled). For organizations, they handle invoices and site licenses, too. For more information, run the enclosed “Register” program. It creates a customized registration form and tells you where to send it.
  28.  
  29. After you register, you will be sent a trick to disable the Annoying Shareware Message™ that appears at startup. Because of this, it is vital that you give your e-mail address or request a paper receipt (for $1 extra) in Register.
  30.  
  31. Please note that we do not send out updates of Aaron or notification of new verions. A mailing (or e-mailing) list of that size would be unmanageable, and we want to spend our spare time coding, not stuffing envelopes. However,
  32. we do make updates available on all online service and internet Mac software archives. Once you register, you remain registered for all future shareware versions of Aaron, even if we add zillions of feature and raise the price.
  33.  
  34. List of features
  35.  
  36. •    Substitutes Espi Sans Bold 10 for Chicago 12 as the system font.
  37.  
  38. •    The menu bar and menus use a light gray background and a dark blue highlight color. In addition, the menu bar takes on a subtle 3D effect.
  39.  
  40. •    Replaces the standard push buttons, check boxes, and radio buttons with Copland-style 3D shaded ones.
  41.  
  42. •    The header information in Finder windows (the # items... and Name, Size, Kind,... lines at the top of the window) is drawn using a gray background and a subtle 3D effect.
  43.  
  44. •    Automatically installs 3D Copland-style folder icons. There are many versions of these icons floating around in cyberspace. The ones included with Aaron have been tweaked to match the various Copland screen shots as closely as possible. Aaron does not change your system file, so your icons will revert to normal if you disable Aaron.
  45.  
  46. •    Windows and scroll bars are now drawn using the Copland 3D style as seen in the various Copland screen shots. These windows have a WindowShade widget at the top right of the title bar. Clicking on it collapses the window to just its title bar.
  47.  
  48. •    Transforms the Finder progress boxes to look like the Copland screen shots. This also partially affects some progress bars in other applications. It looks so cool that you will be copying and trashing files just to see the progress box!
  49.  
  50. •    Provides a new Copland-style pop-up menu button. This affects only those programs that take advantage of the System 7 pop-up menu routines, so please do not complain if the pop-ups in your favorite application or control panel remain unchanged.
  51.  
  52. •    Those little disclosure triangles in Finder list views take on a slight 3D effect.
  53.  
  54. The Espy Sans font family
  55.  
  56. Espy is a new font designed by Apple's Human Interface people for easy readability on computer screens. Aaron installs Espi Sans Bold 10 as you system font in place of the usual Chicago 12 font, and the font Espi Sans 10 is included with the Aaron package. You should try selecting Espi Sans 10 as your Finder font using the Views control panel. Some people prefer the Espy Sans 9 size for Finder views, but all the Copland screen shots use the 10 point size.
  57.  
  58. You can get the entire Espy font family as part of the eWorld software. Alternatively, these fonts live inside the Apple Guide extension, so you can make a copy of your Apple Guide extension, change its file type to FFIL and its creator to DMOV, and then open it like a suitcase to extract all the Espy fonts. I am told that this font is also used by the Newton and comes with the Newton Toolkit as well as the Newton Toolkit Demo (part of “Programming for the Newton“ by McKeehan and Rhodes). Please note that since Espy was designed to be a screen font, there are not TrueType or PostScript versions for use with printers.
  59.  
  60. Here are some quotes about Aaron
  61.  
  62. “I don't think everyone realizes the power of a ‘change of scenery’ to alter your mood or outlook on life...it makes you literally feel different.” — Kevin Lesniewicz
  63.  
  64. “I never thought I'd get that excited about a button.” — Ed Voas
  65.  
  66. “What can I say? — it works.” — Leo Breebaart
  67.  
  68. Known problems
  69.  
  70. •    On some Macs you may occasionally get gibberish in the menu bar or even crashes when launching applications. This is a bug in the system software, and to get around it you must chop out the “mctb” resource from Aaron using ResEdit. Do not try to edit the currently active Aaron file; edit a copy instead and then replace the original with the edited copy.
  71.  
  72. •    The blue menu highlighting does not work correctly in ClarisWorks and ClarisDraw.
  73.  
  74. •    Some menu bar additions, such as the Now Contact and Reminder icons and various menu bar clocks, erase the 3D gray tinges on the menu bar. Fixing this would be more trouble than it is worth.
  75.  
  76. •    When Aaron is running, menus in Canvas become unreadable. This is a long standing bug in Canvas that conflicts with substitute system fonts.
  77.  
  78. •    If your monitor is set for 256 Colors, then the indicators for DiskLight, In Use, or AppleShare in your menu bar are drawn in yellow and do not show up well against the light gray background. This is a problem with the system's color inverse routines, and there is nothing I can do.
  79.  
  80. •    If you are using or have ever used another program to change your menu colors (such as Aurora or Kolor), then your menu color settings may override Aaron's. This can happen even if you have set your menus back to black and white since those utilities may have left a rogue color resource (specifying black and white as the colors) in your System file. Aurora 3.3 will remove this color resource if you tell it to de-install. Otherwise, to get rid of this, you can either remove all “mctb” resources from your System file with ResEdit or perform a fresh install.
  81.  
  82. •    Aaron must load after the CE Toolbox extension. That is why it is named ~Aaron.
  83.  
  84. •    FrameMaker may complain about a font error when startup up. This is due to FrameMaker's overzealous font checking. There really is no problem, and FrameMaker will continue to work normally.
  85.  
  86. •    If you use Greg's Buttons with Aaron, the menu colorization behavior depends on which version of Greg's Buttons you are running. With Greg's Buttons 3.7.1 and earlier, the menu colors in Greg's Buttons override those in Aaron, and you may need to restart for menu color changes to fully take effect. With Greg's Buttons 3.7.2 and later, Aaron's menu colors normally override those in Greg's Buttons. However, if you want to use Greg's Buttons 3.7.2 or later to set your menu colors, you need to make Aaron load after Greg's Buttons at startup. You can do this by putting Aaron in your Control Panels folder.
  87.  
  88. Finder Window Title Bar Icon Caveats
  89.  
  90. •    If you change the icon while the window is open, it will not get the changes until the window is closed and reopened.
  91. •    Since I only get icons when I need them, if you do change the icon, and then say, drag the window to another monitor with a different depth, which requires a different version of the icon from the icon suite, you may end up with a weird looking icon because you may have the mask from the old icon with the new icon on top of it. Yuck.
  92. •    The trash does not show full in the title bar, for now it's always the empty icon. Deal with it, pink boy!
  93.  
  94. Needless to say, there's room for improvement. Please do NOT e-mail these problems to me (Ed).
  95.  
  96. Changes in version 1.0
  97.  
  98. •    Added Copland-style 3D default button frames in dialog boxes.
  99. •    Fixed a conflict with QuickDraw GX that would cause crashes in the Print and Page Setup dialog boxes.
  100. •    Fixed the conflict with MicroPhone.
  101. •    Fixed a bug that would cause Eudora to hang/crash when opening a help window.
  102. •    Fixed a bug that could cause the system font to occasionally revert back to Chicago 12.
  103. •    Aaron now works correctly non-Roman scripts, such as Kanji, Hebrew, or Greek (but not Icelandic, I'm afraid). It specifically checks for Chicago 12 instead of blindly replacing the system font with Espi Sans Bold 10.
  104. •    The new 3D progress bar now appears in the Copy dialog box on German systems.
  105. •    Fixed a bug that could cause “Find File” to crash when you click in a pop-up menu.
  106. •    Expanded modal dialog boxes a few pixels. This gives Now SuperBoomerang (and Norton Directory Assistance?) enough room to display its menus in the Open and Save boxes without overlapping the window border.
  107. •    Command clicking in the title bar of inactive windows to move them now works again.
  108. •    Fixed a problem with the grow box in the Launcher window.
  109. •    Slightly modified the check boxes, radio buttons, window widgets, and scroll bar arrows.
  110. •    The pop-up menus now support icons.
  111. •    Aaron now supports color titles for radio buttons, check boxes, and push buttons.
  112. •    The buttons now correctly handle “254-highlighting” (an obscure technical thing).
  113. •    The windows now draw better in 16 colors.
  114. •    Aaron now uses the Greg's Buttons dialog box color for Finder progress boxes.
  115.  
  116. Changes in version 1.0b5
  117.  
  118. New Features/Improvements
  119. •    Hacked the Finder progress boxes to look like the Copland screen shots.
  120. •    Added Copland-style disclosure triangles in Finder list views.
  121. •    Added Copland-style pop-up menu controls.
  122. •    Added ‘ghosting’ effect to the scroll bar thumb when dragged. This feature conflicts with the Scrolling control panel, and it does not work correctly on some Macs. In order to use the ghost thumb, you must switch it on by editing the “SPrf” resource in ResEdit.
  123. •    Finder window title bars should now be getting the correct icon. It now pays attention to custom icons and labels.
  124. •    The windows are now pixel for pixel identical to the Copland screen shots, except as noted below.
  125. •    Added the window drop shadow. I don't know if I like it, but it is faithful to the actual. The lower left portion of the shadow does not go all the way to the edge of the window like in the screen shots. Sorry.
  126. •    Added another option in the “WPrf” resource for turning icons in Finder window title bars on or off. The icons can slow you down a little. If you have a fast machine, I would not worry about it.
  127. •    Made the radio buttons smoother, lightened the blue menu highlight color, and improved the 3D menu bar.
  128.  
  129. Bug Fixes
  130. •    Eliminated the rogue black lines that would appear when using ClarisWorks.
  131. •    The New Folder button now draws correctly when highlighted on black and white monitors.
  132. •    Fixed conflict with Folder Icon Maker where Aaron's folder icons would override custom folder icon files.
  133. •    Desktop printers windows no longer have a gray header.
  134. •    Fixed a bug that could corrupt the trash can icon.
  135. •    Fixed problem with buttons in Quark.
  136. •    Fixed problem with BBEdit that would turn the text gray after a paste operation.
  137. •    The “WPrf” resource now has a template that ResEdit can understand.
  138. •    Fixed problem where moving the scroll bar thumb to the top/left of the scroll bar would cause it to jump to the end.
  139. •    Fixed compatibility problem with the Scrolling cdev and ZTerm.
  140. •    Fixed problem where closing a windowshaded window would cause a weird desktop update.
  141. •    Changed grow box drawing behavior to only draw when called upon. This fixes the problem where the Chooser and Get Info boxes had grow boxes, but introduces another: occasionally Finder windows will not have a grow box when initially drawn. This is because the Finder has not told the WDEF to draw any grow boxes yet. Once the window becomes active, everything is normal from that point on.
  142. •    Clicking the windowshade button no longer causes ProTERM to quit.
  143. •    Wünderbar now works wünderbar. You *may* notice a slight irregularity when the window is rolled up, though.
  144. •    You can no longer move the window by clicking in the lower right edge of the window. That land has been taken over by the evil yet ever-flexible Grow Box Empire! So no more dragging when you meant to resize.
  145. •    Window titles now draw properly when in Stuffit Lite (and probably Deluxe as well).
  146. •    Window title embossing now uses a slightly darker gray, so it is not so blatant.
  147.  
  148. Changes in version 1.0b4
  149.  
  150. •    Added the WindowShade widget to the top right of the title bar.
  151. •    Windows now roll up properly when using WindowShade (no pixels left hanging off the bottom).
  152. •    Added a 'WPrf' resource to allow disabling of window title embossing, for you purists.
  153. •    Fixed problem where clicking in the grow portion of an inactive window would grow it when in fact it should have merely activated it.
  154. •    You can no longer resize a rolled up window. That was not good.
  155. •    Changed the trash can icon yet again.
  156. •    Changed the Aaron extension icon slightly.
  157. •    Aaron now draws the button frame correctly for selected push buttons on black and white monitors.
  158.  
  159. Changes in version 1.0b3 (MacHack)
  160.  
  161. •    Fixed a bug that would occasionally substitute other controls (such as sliders) for buttons.
  162. •    Fixed a bug at startup that EvenBetterBusError (EBBE) caught.
  163. •    Fixed a bug that could prevent Aaron from changing the System font to Espi Sans Bold 10.
  164. •    Aaron now lets application-specific WDEFs override its window routines.
  165.  
  166. Changes in version 1.0b2
  167.  
  168. •    Added Copland-style windows and scroll bars, courtesy of Ed Voas.
  169. •    The empty and full trash can icons now use a gray shadow instead of a black one.
  170. •    Aaron no longer draws the white highlight at the top of the screen if the menu bar is hidden.
  171. •    Aaron now has an extension icon which it draws at startup.
  172. •    Changed the name to ~Aaron so that it loads after CE Toolbox.
  173. •    Aaron can now coexist with Greg's Buttons. The settings in Greg's Buttons override Aaron.
  174.  
  175. Disclaimer
  176.  
  177. The authors, Gregory D. Landweber and Edward Voas, make no warranties, either express or implied, regarding the fitness of “Aaron” for any particular purpose. Use “Aaron” at your own risk. The authors claim no liability for data loss or any other problems caused directly or indirectly by “Aaron”.